home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat4 / pagesizes.Z / pagesizes
Encoding:
Text File  |  1999-07-16  |  4.8 KB  |  132 lines
  1.  
  2.  
  3.  
  4. PPPPAAAAGGGGEEEESSSSIIIIZZZZEEEESSSS((((4444FFFF))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((DDDDeeeecccceeeemmmmbbbbeeeerrrr 5555,,,, 1111999999994444))))    PPPPAAAAGGGGEEEESSSSIIIIZZZZEEEESSSS((((4444FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pagesizes - _H_y_l_a_F_A_X page size definitions
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The _p_a_g_e_s_i_z_e_s database defines the page dimensions and
  13.      guaranteed reproducible areas (GRA) for well-known page
  14.      sizes.  The GRA is the portion of the page that is
  15.      guaranteed to be imaged during facsimile transmission.  This
  16.      region is typically less than the full page dimensions
  17.      because of paper roller contacts and other mechanical
  18.      aspects of the printing process in a facsimile machine.
  19.  
  20.      All _H_y_l_a_F_A_X programs that require page size information read
  21.      the information from this database using a page size name.
  22.      Documents should be prepared such that the full page
  23.      dimensions are employed with the imaged area contained
  24.      within the GRA.
  25.  
  26.      The system-wide default page size to use in preparing
  27.      documents for transmission is given by the ``_d_e_f_a_u_l_t'' entry
  28.      in the database.  (NB: the default entry should be placed
  29.      last so that inverse matches find the real page size name
  30.      and not the default entry.)
  31.  
  32.      The page size database is an ASCII file with the following
  33.      format.  Each entry consists of whitespace-separated fields:
  34.      name  abbrev  width  height  gra-width  gra-height  top-margin  left-margin
  35.      Fields have the following interpretation:
  36.  
  37.      nnnnaaaammmmeeee        the full name for the page size; e.g. ISO A4;
  38.  
  39.      aaaabbbbbbbbrrrreeeevvvv      an abbreviated version of the full name for use
  40.                  in compact listings such as the receive queue
  41.                  listing printed by _f_a_x_s_t_a_t(1);
  42.  
  43.      wwwwiiiiddddtttthhhh       the full width of the page;
  44.  
  45.      hhhheeeeiiiigggghhhhtttt      the full height of the page;
  46.  
  47.      ggggrrrraaaa----wwwwiiiiddddtttthhhh   the width of the GRA;
  48.  
  49.      ggggrrrraaaa----hhhheeeeiiiigggghhhhtttt  the height of the GRA;
  50.  
  51.      ttttoooopppp----mmmmaaaarrrrggggiiiinnnn  the margin between the top of the full page and
  52.                  the top of the GRA;
  53.  
  54.      lllleeeefffftttt----mmmmaaaarrrrggggiiiinnnn the margin between the left side of the full
  55.                  page the left side of the GRA.
  56.  
  57.      The first two fields must be separated from the subsequent
  58.      fields by a tab character (possibly followed by more
  59.  
  60.  
  61.  
  62. Page 1                                          (printed 6/24/99)
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. PPPPAAAAGGGGEEEESSSSIIIIZZZZEEEESSSS((((4444FFFF))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((DDDDeeeecccceeeemmmmbbbbeeeerrrr 5555,,,, 1111999999994444))))    PPPPAAAAGGGGEEEESSSSIIIIZZZZEEEESSSS((((4444FFFF))))
  70.  
  71.  
  72.  
  73.      whitespace); this is done to easily permit blank characters
  74.      to be included in names.  Otherwise fields can be separated
  75.      by any amount of any kind of whitespace.  Numbers are all
  76.      base 10 and in basic measurement units (BMU); defined as
  77.      1/1200 x 25.4 millimeters for paper output with a scale
  78.      factor of one.  All fields must be present on a single line;
  79.      otherwise the entry is ignored.  Comments are introduced by
  80.      the ``#'' character and continue to the end the line.
  81.  
  82.      Page size database lookups are either by name or by page
  83.      dimensions.  Lookups by name are done by sequentially
  84.      scanning the entries in the database for the first entry
  85.      that has a matching abbreviation or substring of the page
  86.      size name field.  The string comparisons ignore case so, for
  87.      example, ``a4'' would match a full name of ``ISO A4''.
  88.      Lookups by dimension scan the entire database and return the
  89.      page with the closest dimensions using a straightforward
  90.      distance metric.  If the difference in dimensions of the
  91.      closest match is greater than 1/2 inch on each side, then no
  92.      page entry is returned for a lookup by dimension.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      _h_y_l_a_f_a_x(1), _f_a_x_m_a_i_l(1), _f_a_x_s_t_a_t(1), _s_e_n_d_f_a_x(1), _s_g_i_2_f_a_x(1),
  96.      _t_e_x_t_f_m_t(1).
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Page 2                                          (printed 6/24/99)
  129.  
  130.  
  131.  
  132.